home *** CD-ROM | disk | FTP | other *** search
/ Cream of the Crop 22 / Cream of the Crop 22.iso / os2 / wam101.zip / WHACK.TXT < prev   
Text File  |  1996-09-12  |  9KB  |  209 lines
  1.  
  2. Whack-A-Mole for OS/2!
  3. ----------------------
  4. This is my OS/2 interpretation of a carnival game called Whack-A-Mole.
  5. The original was a board with some holes in it.  Mechanical "Moles" 
  6. would briefly stick their heads out from a random hole.  The player
  7. had to whack the mole with a mallet before it returned to its hole.
  8. I have taken license with some of the features.  Rather than being
  9. limited to four or five holes, these moles have the freedom to
  10. appear anywhere on your screen, even on top of one another.  If you
  11. are opposed to whacking moles, and have the appropriate bitmaps handy,
  12. whack Bob Dole, your boss, or Barney the Dinosaur instead.  Whack-A-Mole
  13. is SHAREWARE.  Please read the registration information in this document.
  14.  
  15. Thanks for trying Whack-A-Mole!
  16.  
  17.  
  18. Installation
  19. ------------
  20. Simply copy the executable and dll to whichever directory you want,
  21. create an object for it on your desktop, and start banging away.  The
  22. first time it runs, Whack-A-Mole will create a file called Whack.ini in
  23. the same directory as the executable.  A high score file, whack.hsc will
  24. also be created.
  25.  
  26.  
  27. The Controls
  28. ------------
  29. Number of Moles:  This control will let you adjust the number of moles
  30.                   in a game, from ten up to 1000.  The default is 22.
  31.  
  32. Speed:  This control lets you adjust the frequency at which moles
  33.         appear.
  34.  
  35. Restore Defaults:  This controls restores the default number of moles
  36.                    and default speed.
  37.  
  38. Start Game: I think this one is self explanatory.
  39.  
  40. Stop Game:  Ditto.
  41.  
  42. Settings...:    This brings up the Settings notebook.  The notebook
  43.                 currently has two pages.
  44.     Notebook Page 1:    This page contains bitmap options and a preview
  45.                         of the currently loaded bitmap.  The name of the
  46.                         current bitmap is displayed at the top.  Buttons
  47.                         allow you to change the bitmap or restore the
  48.                         default bitmap.
  49.     Notebook Page 2:    This page contains sound effect options.  The name
  50.                         of the current sound effect is displayed at the
  51.                         top.  Buttons allow you to change and try out
  52.                         sound effects, and restore the default effect.  A
  53.                         checkbox allows you to disable the sound.
  54.  
  55.                         If you don't have multimedia installed or don't
  56.                         have a sound card, the options on this page will
  57.                         be disabled.  If you have multimedia AND a sound
  58.                         card supported by OS/2, and the options are
  59.                         disabled, it's a bug.  Please let me know about
  60.                         it.
  61.  
  62.                 In addition to the notebook pages, the Settings dialog has
  63.                 three buttons.  Defaults, Save, and Done.  Defaults will
  64.                 restore the default bitmap AND the default sound effect.
  65.                 Save will save the current bitmap and sound options, and
  66.                 Done will dismiss the notebook.
  67.  
  68. High Scores:    Displays the 10 best scores achieved.  In the high
  69.                 scores dialog box, you have the option to clear the
  70.                 high scores.  I placed this button far from the Ok
  71.                 button to make it more difficult to hit by accident.
  72.  
  73. About Whack-A-Mole: Displays the support and copyright information for
  74.                     Whack-A-Mole.
  75.  
  76. Quit:   Another one that needs no explanation.
  77.  
  78.  
  79. The Play
  80. --------
  81. Simply adjust the above-mentioned controls as desired, and hit the
  82. start game button.  As moles appear in random locations on the screen,
  83. you must whack them as quickly as possible.  The titlebar of the main
  84. window will keep track of the number of moles created thus far in the
  85. game.  If you don't want to play all the way to the end, simply whack
  86. the moles covering the Stop Game or Quit button, and click on said
  87. button.  All the moles will disappear, and the game will be over.
  88.  
  89.  
  90. The Scoring
  91. -----------
  92. I had a rough time deciding how to score this, but finally decided to
  93. award 4 points if the mole is whacked in under 1/2 second, 3 points if
  94. you get it in between 1/2 and 1 second, 2 points between 1 and 1.5
  95. seconds, and 1 point up to 2 seconds.  After that, you get zero points.
  96. Each of these scores is weighted by the speed at which you are playing,
  97. from 1 up to 11.  So, the maximum score you can get for any given mole is
  98. 44 points.  At the end of the game, if you've made it into the top 10,
  99. you'll be given a chance to enter your name (up to 32 characters).  The
  100. top 10 high scores will then be displayed.
  101.  
  102. ------------------------------------------------------------------------
  103.  
  104. Future Plans
  105. ------------
  106.  
  107. German language support is sort of in the works, as I know a bit of
  108. German.  If you want to see other languages, then you'll have to translate
  109. for me.
  110.  
  111. I have already received input from testers regarding new features they
  112. would like to see.  They said:
  113.  
  114. * Use a second bitmap, so that when you whack the mole, it changes to
  115.   a bloody mole or something.  I actually have the bloody mole bitmap, but
  116.   need to add the code.
  117.  
  118. * Allow the player to use different mouse cursors.
  119.  
  120. * Animate the mouse cursor, so that the mallet looks like it's swinging.
  121.  
  122. Performance is a priority, so I will weigh the performance hit of any
  123. new features before deciding to add them.  If there are any new features
  124. that you would like to see, feel free to contact me.  I'll be much more
  125. likely to add the features if you are a registered user ( see below ).  I
  126. am also interested in ideas for new projects.  If there's something you
  127. want for OS/2, contact me about it.  I'm still coming up to speed on OS/2
  128. programming, but I'll be happy to give it a try.
  129.  
  130. Please email your suggestions and bug reports to
  131.     erlkonig@randomc.com
  132.  
  133.  
  134. Known Bugs
  135. ----------
  136. None.  Finally.
  137.  
  138.  
  139. Registration
  140. ------------
  141. This is my first piece of shareware, and my first real bit of PM coding.
  142. Don't cause me to become disillusioned with the shareware concept.  If
  143. you like the game, you must register it after 14 days.  The cost is only
  144. $5.00 US (check or money order only, for your safety), sent to:
  145.  
  146. Matthew Wagner
  147. PsychoSemantic Software
  148. 1122 RIVA RIDGE DR
  149. NORCROSS GA 30093
  150.  
  151. If you provide me with your email address, I will acknowledge your
  152. registration and keep you informed of updates.  There are no missing
  153. features or nag screens in the shareware version, so your only
  154. motivation for registering is a clean conscience. Your registration is
  155. valid for all future shareware releases of Whack-A-Mole.  If a large
  156. wealthy company buys the rights from me, you're at their whim.
  157.  
  158.  
  159. License and Disclaimer
  160. ----------------------
  161. By using this software, you agree to the following terms.
  162.  
  163. Whack-A-Mole is not free.  The shareware version of Whack-A-Mole is
  164. licensed to you to try for 14 days.  At the end of that period, you
  165. must register the software or remove all copies from your system.
  166. Upon registering, you are licensed to install Whack-A-Mole on as
  167. many computers as you desire, provided only one copy will be in use at
  168. any given time.  You may freely distribute Whack-A-Mole, provided you
  169. distribute the entire archive, original and unmodified, including this
  170. documentation.  You may not alter, disassemble, or otherwise reverse
  171. engineer Whack-A-Mole.
  172.  
  173. If you are dissatisfied with Whack-A-Mole, I will be happy to refund
  174. your registration fee.  There are no other warranties, express or implied.
  175. The author and PsychoSemantic Software are not responsible for any damage,
  176. direct or indirect, caused to your computer, productivity, or anything
  177. else by this software.  This software is not warranted to be free of bugs.
  178.  
  179. This software may not be used for military purposes.  It may be used by
  180. military personnel for nonmilitary purposes only.
  181.  
  182. History
  183. -------
  184. 1.01    Sept 12, 1996    Fixed path bug
  185. 1.0    Sept 2, 1996    Initial Release
  186.  
  187. About the Author
  188. ----------------
  189. I received my BS in Mathematics from MIT in 1993, and my MS in Applied
  190. Mathematics from the University of Arizona in 1995.  I program in C on
  191. OS/2, MVS, AS400, and Windows NT for FormMaker Software, Inc.  I'm writing
  192. OS/2 shareware on the side to help pay back my large college debt.
  193.  
  194.  
  195. Thanks
  196. ------
  197. A short list of those I'm indebted to.
  198.  
  199. * Andy Key, for releasing his excellent GBM source to the public domain.
  200. * Whoever wrote BITMAP32 and published the source on the DevCon cd's.
  201. * The guys at FormMaker software, for testing this stuff and ragging me
  202.   when it didn't work.
  203. * Mike Compton at FormMaker, for drawing my bitmaps.
  204. * The authors of all the excellent OS/2 software, for setting a great
  205.   example.
  206. * Everyone who registers Whack-A-Mole and helps support further OS/2
  207.   development.
  208.  
  209.